GREB MCP Server
Semantic code search for AI agents without indexing your codebase or storing any data. Fast and accurate.
Available on npm (cheetah-greb) and PyPI (cheetah-greb).
FEATURES
- Natural Language Search: Describe what you're looking for in plain English
- High-Precision Results: Smart ranking returns the most relevant code first
- Works with Any MCP Client: Claude Desktop, Cursor, Windsurf, Cline, Kiro, and more
- No Indexing Required: Search any codebase instantly without setup
- Fast: Results in under 5 seconds even for large repositories
INSTALLATION
Install Greb globally using pip or npm.
Python:
pip install cheetah-greb
Node.js:
npm install -g cheetah-greb
GET YOUR API KEY
1. Go to Dashboard > API Keys at https://grebmcp.com/dashboard/api-keys
2. Click "Create API Key"
3. Copy the key (starts with grb_)
CONFIGURATION
Add to your MCP client config (Cursor, Windsurf, Claude Desktop, Kiro, etc.):
Python installation:
{
"mcpServers": {
"greb-mcp": {
"command": "greb-mcp",
"env": {
"GREB_API_KEY": "grb_your_api_key_here"
}
}
}
}
Node.js installation:
{
"mcpServers": {
"greb-mcp": {
"command": "greb-mcp-js",
"env": {
"GREB_API_KEY": "grb_your_api_key_here"
}
}
}
}
CLAUDE CODE SETUP
Mac/Linux (Python):
claude mcp add --transport stdio greb-mcp --env GREB_API_KEY=grb_your_api_key_here -- greb-mcp
Windows PowerShell (Python):
claude mcp add greb-mcp greb-mcp --transport stdio --env "GREB_API_KEY=grb_your_api_key_here"
Mac/Linux (Node.js):
claude mcp add --transport stdio greb-mcp --env GREB_API_KEY=grb_your_api_key_here -- greb-mcp-js
Windows PowerShell (Node.js):
claude mcp add greb-mcp greb-mcp-js --transport stdio --env "GREB_API_KEY=grb_your_api_key_here"
TOOL: code_search
Search code using natural language queries powered by AI.
Parameters:
- query (string, required): Natural language search query
- keywords (object, required): Search configuration
- keywords.primary_terms (string array, required): High-level semantic terms (e.g., "authentication", "database")
- keywords.code_patterns (string array, optional): Literal code patterns to grep for
- keywords.file_patterns (string array, required): File extensions to search (e.g., ["*.ts", "*.js"])
- keywords.intent (string, required): Brief description of what you're looking for
- directory (string, required): Full absolute path to directory to search
Example:
{
"query": "find authentication middleware",
"keywords": {
"primary_terms": ["authentication", "middleware", "jwt"],
"code_patterns": ["authenticate(", "isAuthenticated"],
"file_patterns": ["*.js", "*.ts"],
"intent": "find auth middleware implementation"
},
"directory": "/Users/dev/my-project"
}
Response includes:
- File paths
- Line numbers
- Relevance scores
- Code content
- Reasoning for each match
USAGE EXAMPLES
Ask your AI assistant to search code naturally:
"Use greb mcp to find authentication middleware"
"Use greb mcp to find all API endpoints"
"Use greb mcp to look for database connection setup"
"Use greb mcp to find where user validation happens"
"Use greb mcp to search for error handling patterns"
LINKS
Website: https://grebmcp.com
Documentation: https://grebmcp.com/docs
Get API Key: https://grebmcp.com/dashboard/api-keys
Overview
What is Greb MCP?
Greb MCP is a semantic code search tool designed for AI agents, allowing users to search their codebases using natural language queries without the need for indexing or data storage.
How to use Greb MCP?
To use Greb MCP, install it via npm or pip, obtain an API key from the dashboard, and configure it with your MCP client. You can then perform searches by describing what you're looking for in plain English.
Key features of Greb MCP?
- Natural Language Search: Search using plain English descriptions.
- High-Precision Results: Smart ranking returns the most relevant code first.
- Works with Any MCP Client: Compatible with various clients like Claude Desktop, Cursor, and Windsurf.
- No Indexing Required: Instantly search any codebase without setup.
- Fast Results: Get results in under 5 seconds, even for large repositories.
Use cases of Greb MCP?
- Finding specific code implementations like authentication middleware.
- Searching for API endpoints or database connection setups.
- Locating error handling patterns in large codebases.
FAQ from Greb MCP?
- Can Greb MCP search any codebase?
Yes! It can search any codebase instantly without indexing.
- Is there a cost to use Greb MCP?
No, Greb MCP is free to use.
- How fast are the search results?
Results are typically returned in under 5 seconds.
Server Config
{
"mcpServers": {
"greb-mcp": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "greb-mcp-js",
"args": [],
"env": {
"GREB_API_KEY": "grb_your_api_key_here"
}
}
}
}